home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / comm / fido / Rock_1_5.lha / ROCK / LaunchWPL.DOC < prev    next >
Text File  |  1995-04-22  |  2KB  |  64 lines
  1.  
  2.     LaunchWPL.DOC
  3.     Robert Williamson 
  4.  
  5.     LaunchWPL  is  a  combination of the original LoadScript and Launch WPL
  6. commands.   It  is  intended for use with single module wpl mailers such as
  7. Pop by Denis Turcotte, JamMail by James McOrmond and Jaz by myself.
  8.  
  9.   To load and launch a wpl program:
  10.   LoadWPL <scriptname> <fullpathname> <portname> <script!label> <priority> <stack>
  11.  
  12.   To flush a wpl program:    
  13.   LaunchWPL <scriptname> ""
  14.  
  15.     Much  of  the  remainder  of  this  doc  was  derived  or modified from
  16. messages and documentation by Russell McOrmond.
  17.  
  18.   LoadWPL  tells  wpl.library  to load the file named in <fullpathname> and
  19. bind  this  to  the  name  <scriptname>.   The  scriptname  is then used to
  20. reference  this script in Launch, SubJump, Post/Preinbound/Outbound labels,
  21. and of course other 'loadscript' references.
  22.  
  23.   The <portname> must be a *UNIQUE* message port name.  A recommendation is
  24. for all WPL application developers to adopt a system where they include the
  25. name of their application in the name.
  26.  
  27.   The <script!label> is the label at which the slave is started.  The label
  28. is  normally  'startup'.   You'll  notice  that  it has the <scriptname> in
  29. front.   If  the  system  does  not  specify  the  script name then it will
  30. reference 'the first script loaded'.
  31.  
  32.   The <priority> is the process priority for the wpl program.
  33.  
  34.   The  <stack> is the process stack size in bytes (Make sure this is fairly
  35. large).
  36.  
  37.  
  38.   Note  that doing a 'LaunchWPL' on a script that has no current users will
  39. cause  it  to  RE-LOAD  that  script  into memory.  If there are any users,
  40. however, a re-load of a script will FAIL.
  41.  
  42.  If  a  LaunchWPL  is  issued  with  only  the <scripname> and there are no
  43. current users, it will be flushed from memory.
  44.  
  45.     LaunchWPL <scriptname> ""
  46.  
  47.     Return Codes:
  48.  
  49.               Load                              Flush
  50.  
  51.           0 - All OK so far                     Flushed OK
  52.           1 - Can't create public port          --
  53.           2 - Can't open timer                  --
  54.           3 - Can't allocate vars structure     --
  55.           4 - Can't open xferq.library          --
  56.           5 - Error loading <fullpathname>      Unable to flush
  57.          99 - No memory in slave                --
  58.         101 - No memory for structure           --
  59.         102 - Error in new process launching    --
  60.         666 - Unable to open wpl.library        same
  61.         999 - Invalid number of arguments       same
  62.  
  63.  
  64.